InchGroup
命令永不停止的控制运动在有最大距离限制下以指定速度移动,当轴到达最大距离时将会自动停止。
语法
KsCommandStatus InchGroup(
int Index,
int Length,
double* Distance,
double* Velocity,
double Acceleration,
double Deceleration,
double Jerk,
McCoordSystem CoordSystem
);
参数
Index [in]:轴组索引,索引以零为起点。最多可有 32 个轴组。
Length [in]: 距离 (Distance) 或速度 (Velocity) 的长度,两者长度相同。
Distance [in]:此运动移动的最大距离。
Velocity [in]:指定速度的值,[单位/秒]。
Acceleration [in]:加速度值,单位由 McProfileType 类型决定,(马达的增加能源) [单位/秒2] 或 [秒]。
Deceleration [in]:减速度值,单位由 McProfileType 类型决定,(马达的减少能源) [单位/秒2] 或 [秒]。
Jerk [in]:加加速度值,单位由 McProfileType 类型决定,为 [单位/秒3] 或 [秒]。
CoordSystem [in]:座标系统,仅支援 ACS。请见 McCoordSystem 类型。
回传值
返回 KsCommandStatus 结构。
备注
- Velocity、Acceleration、Deceleration 与 Jerk 为组内各轴设定值,而非路径值,若其中之参数值(如 Acceleration)超过组内之一轴的最大 Acceleration,该轴将使用自己的最大 Acceleration 值,而其他轴使用提供的值。
- Velocity 与 Distance 可在轴组运行时修改。
- Distance 阵列的元素必须大于零 (> 0),也就是说每一轴移动的距离皆大于零 (> 0)。
- InchGroup 仅可于 GroupStandstill 状态中使用。
- 若组中的一个轴完成了移动而其他轴还未完成,欲维持该轴移动,有两种选择:
- 增加距离。此轴将在另一个移动中移动增加的部分,例如将距离从 2000 改为 2500,轴将在移动 2000 单位后移动 500 单位。
- 改变该轴速度。轴将使用新的速度行驶当前的距离。
重要:若距离很短且速度很快,则轴的“煞停距离”可能会超过指定的距离,这可能会导致轴故障。
范例
N/A
使用需求
RT | Win32 | |
---|---|---|
最低支援版本 | 4.0 | 4.0 |
标头档 | ksmotion.h | ksmotion.h |
程式库 | KsApi_Rtss.lib | KsApi.lib |
参见